@fremtind/jkl-core
Advanced tools
@fremtind/jkl-coreInneholder grunnstilen til designsystemet Jøkul. Inneholder også et normaliserings-stilark som sørger for at alle nettlesere har samme utgangspunkt når de skal vise en Fremtind-side.
Dersom du skal bygge komponenter for Fremtind, utover de som finnes i Jøkul, bør du bruke variablene her. Det sørger for at farger, sperring, typografisk skala og liknende holder seg oppdatert mot endringer i designsystemet.
Se portalen for bruk og prinsipper.
npm i @fremtind/jkl-core.import { initTabListener, Link } from "@fremtind/jkl-core";
initTabListener();
// Importer stilark via JavaScript med CSS-loader.
import "@fremtind/jkl-core/core.min.css";
// Eller importer stilark via SCSS.
@use "@fremtind/jkl-core/core";
// Bruk Jøkuls mixins, funksjoner og variabler via jkl-modulen.
@use "@fremtind/jkl-core/jkl";
@include jkl.light-mode-variables {
// ...
}
// Du finner også variablene fra Jøkul i Less-format her
@import "@fremtind/jkl-core/tokens.less";
jklFor at CSSen i Jøkul skal fungere som forventet må du sette klassen jkl på rotnivå i applikasjonen din.
Vi bruker jkl-klassen til å blant annet:
Du har kanskje en komponent som heter Layout eller App hvor du kan sette denne klassen? Om du er usikker, sett klassen på body.
import React, { FC } from "react";
import { WithChildren } from "@fremtind/jkl-core";
export const Layout: FC<WithChildren> = ({ children }) => {
return <div className="jkl">{children}</div>;
};
initTabListener()Av tilgjengelighetshensyn viser vi fokusomriss på interaktive elementer når man navigerer en løsning ved hjelp av tastaturet. Normalt blir disse omrissene også vist når man bruker musen for navigasjon, noe vi ikke ønsker.
Hjelpefunksjonen initTabListener() sørger for å sette et flagg på <body> når man navigerer med musen, som skjuler omrissene. Importer og kall funksjonen på rotnivå i prosjektet ditt (der siden rendres).
import { initTabListener } from "@fremtind/jkl-core";
initTabListener();
Noen løsninger, spesielt rådgiverløsninger, har behov for å vise veldig mye informasjon på skjermen samtidig. Derfor ønsker vi å tilby kompakte versjoner av komponentene til dette formålet.
For å gjøre det enklere å ha kompakt modus på en hel løsning tillater vi å sette en attributt data-layout-density="compact" på <body> (eller et annet element) slik at alle komponenter inne i dette elementet blir kompakte.
getValuePair()Noen komponenter, som Select og RadioButtons, kan ta inn verdier enten som en streng eller som et ValuePair-objekt med en value og et label. Hjelpefunksjonen getValuePair konstruerer et ValuePair fra en string, for å sikre enkel implementasjon av disse komponentene. Funksjonen sender gjennom ValuePair-objekter uendret:
import { getValuePair } from "@fremtind/jkl-core";
getValuePair("En verdi"); // { label: "En verdi", value: "En verdi" }
const value = { label: "En annen verdi", value: "value2" };
getValuePair(value); // returnerer objektet som det er
Denne er fin å bruke sammen med map() for å rendre valg:
const choices = ["Valg 1", "Valg 2", "Valg 3"];
return choices.map(getValuePair).map((choice) => (
<option selected={choice.value === selectedValue} value={choice.value}>
choice.label
</option>
));
Vind er et subset av Tailwind CSS, med grunnlag i Jøkuls design tokens, som fokuserer på:
import "@fremtind/jkl-core/core.min.css";
// Vind trenger core og klassen jkl på rotnivå for å fungere
import "@fremtind/jkl-core/vind.min.css";
@use "@fremtind/jkl-core/core";
// Vind trenger core og klassen jkl på rotnivå for å fungere
@use "@fremtind/jkl-core/vind";
Du finner igjen disse tingene du kanskje kjenner fra Tailwind:
font-serif finnes ikke)font-normal og font-bold)Vi har egne utils for typografi som passer med vår egen typografiskala.
.title
.title-small
.heading-1
.heading-2
.heading-3
.heading-4
.heading-5
.body
.small
Åpne et issue med feature-ønsker, så kan vi finne ut av det sammen.
Per nå har vi ikke noen ferdig konfigurasjon som er klar for Tailwind eller andre utility-baserte verktøy, men vi eksporterer alle design tokens som JavaScript.
Du kan importere tokensene i tailwind.config.js og bygge opp konfigurasjonen din på den måten:
import { tokens, breakpoints } from "@fremtind/jkl-core";
import plugin from "tailwindcss/plugin";
export default {
content: ["./index.html", "./src/**/*.{js,ts,jsx,tsx}"],
theme: {
extend: {},
colors: tokens.color,
spacing: tokens.spacing,
fontSize: null,
lineHeight: null,
},
plugins: [
plugin(function ({ addComponents }) {
addComponents({
".title": {
...tokens.typography.title.small,
[`@media (min-width: ${breakpoints.medium}px)`]: {
...tokens.typography.title.base,
},
},
".title-small": {
...tokens.typography.titleSmall.small,
[`@media (min-width: ${breakpoints.medium}px)`]: {
...tokens.typography.titleSmall.base,
},
},
".heading-1": {
...tokens.typography.heading_1.small,
[`@media (min-width: ${breakpoints.medium}px)`]: {
...tokens.typography.heading_1.base,
},
},
".heading-2": {
...tokens.typography.heading_2.small,
[`@media (min-width: ${breakpoints.medium}px)`]: {
...tokens.typography.heading_2.base,
},
},
".heading-3": {
...tokens.typography.heading_3.small,
[`@media (min-width: ${breakpoints.medium}px)`]: {
...tokens.typography.heading_3.base,
},
},
".heading-4": {
...tokens.typography.heading_4.small,
[`@media (min-width: ${breakpoints.medium}px)`]: {
...tokens.typography.heading_4.base,
},
},
".heading-5": {
...tokens.typography.heading_5.small,
[`@media (min-width: ${breakpoints.medium}px)`]: {
...tokens.typography.heading_5.base,
},
},
".body": {
...tokens.typography.body.small,
[`@media (min-width: ${breakpoints.medium}px)`]: {
...tokens.typography.body.base,
},
},
".small": {
...tokens.typography.small.small,
[`@media (min-width: ${breakpoints.medium}px)`]: {
...tokens.typography.small.base,
},
},
});
}),
],
};
FAQs
Jøkul core styles
The npm package @fremtind/jkl-core receives a total of 363 weekly downloads. As such, @fremtind/jkl-core popularity was classified as not popular.
We found that @fremtind/jkl-core demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.
Security News
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.